Walkthrough

Clear GC-sensitive vnode references in Suspense: remove fallback vnode el after transitions/unmounts when in fallback, clear vnode.placeholder before removing placeholder during async resolution, and expose isInFallback on the internal suspense boundary for these cleanups.

Changes

Sequence Diagram(s)

sequenceDiagram
  autonumber
  participant Async as Async dep / component
  participant Suspense as Suspense boundary
  participant Fallback as Fallback VNode (ssFallback)
  participant Placeholder as Placeholder VNode
  participant DOM as DOM

  Note over Suspense,Async: Async dependency resolves / transitions complete
  Async->>Suspense: resolve()
  Suspense->>Suspense: determine isInFallback
  alt delayed enter finished & in fallback
    Suspense->>Fallback: clear `el` reference (fallback.el = null)
    Suspense->>DOM: remove fallback/active nodes
  else unmount active branch & in fallback
    Suspense->>Fallback: clear `el` reference (fallback.el = null)
    Suspense->>DOM: remove active branch nodes
  end

  Note over Suspense,Placeholder: removing placeholder during resolve
  Suspense->>Placeholder: set `placeholder = null`
  Suspense->>DOM: remove placeholder node

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

• Review focus:
  • packages/runtime-core/src/components/Suspense.ts — ensure clearing el/placeholder is safe across all suspend/resolve/unmount code paths.
  • Verify isInFallback exposure doesn't change external behavior or lifecycle assumptions.
  • Check transition/delayed-enter edge cases to avoid premature clears.

Possibly related PRs

• fix(runtime-core): ensure correct anchor el for unresolved async components #13560 — touches Suspense placeholder and anchor handling; closely related to vnode.placeholder and ssFallback changes.

Poem

I tidy hollows, nibble threads away,
Drop tiny links so memory can play.
Placeholder freed, fallback set loose,
Hoplight and nimble — a cleaner spruce. 🥕🐇

Pre-merge checks and finishing touches

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

Size Report

Bundles

Usages

Open in StackBlitz

npm i https://pkg.pr.new/@vue/compiler-core@13928

npm i https://pkg.pr.new/@vue/compiler-dom@13928

npm i https://pkg.pr.new/@vue/compiler-sfc@13928

npm i https://pkg.pr.new/@vue/compiler-ssr@13928

npm i https://pkg.pr.new/@vue/reactivity@13928

npm i https://pkg.pr.new/@vue/runtime-core@13928

npm i https://pkg.pr.new/@vue/runtime-dom@13928

npm i https://pkg.pr.new/@vue/server-renderer@13928

npm i https://pkg.pr.new/@vue/shared@13928

npm i https://pkg.pr.new/vue@13928

npm i https://pkg.pr.new/@vue/compat@13928

commit: cd706a4

/ecosystem-ci run

📝 Ran ecosystem CI: Open